home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu130.dms / pu130.adf / Anim_Tools / ShowAnim.doc < prev    next >
Text File  |  1989-09-24  |  9KB  |  176 lines
  1. The version on this disk is actually 5.4, released in April 1989. New docs
  2. were not available at press time.
  3.  
  4.                           ShowANIM  Version 5.30
  5.                              13 September 1988
  6.  
  7.                           written by Gary Bonham
  8.  
  9.                      Copyright (c) 1988 by SPARTA Inc.
  10.                            Laguna Hills, Calif.
  11.                            All Rights Reserved
  12.  
  13. ShowANIM is a freely distributable player for ANIM animation files and for
  14. IFF ILBM picture files.
  15.  
  16. ShowANIM 5.3 represents a significant advance from the previously released
  17. versions, the latest of which was v4.3.  I wish to thank all those who have
  18. contributed suggestions and hope that at least most of you will be pleased
  19. with this release.  The most significant change in this release is a rework
  20. of the internal way of handling overscan and the display in general.  The
  21. result is that this version will support both NTSC and PAL in all resolutions
  22. and all normal levels of overscan.  Overscan levels that have been verified
  23. include no overscan (320/640 x 200/400), medium overscan (352/704 x 220/440),
  24. and severe overscan (384/768 x 240/480).  Also the corresponding levels
  25. for PAL which are identical in width but 56/112 taller.  Note that PAL
  26. overscan will, in general, require more than 512k of chip ram.  Therefore,
  27. you may not be able to utilize these modes until Commodore releases new
  28. chips which permit 1Mb of chip ram.  In addition keyboard
  29. control of animation speed as well as pause/restart/resume has been added,
  30. and full control of ShowANIM can now be specified from a workbench icon via
  31. the tooltypes table (which duplicates all command line parameters when run
  32. from the CLI).
  33.  
  34. In addition, this version will properly handle ANIMs which have new color
  35. maps on each frame.  Also, color cycling is supported.
  36.  
  37. Separate timing is provided for the first and last frame of an animation.
  38. These are defaulted to 3 seconds apiece so running ShowANIM without any
  39. parameters on an ANIM will hold the first frame 3 seconds, play the ANIM,
  40. and then hold on the last frame for 3 seconds before termination.  During
  41. this time you can use the keyboard to pause, or alter other settings such
  42. as looping playback and speed.  If showing a single picture, such as an
  43. IFF ILBM picture from a paint program, the two 3 second delays combine into
  44. one 6 second period during which the picture is displayed.
  45.  
  46. Specific features are as follows:
  47.  
  48. 1) Continuous play mode.  In continuous play it is assumed that the last two
  49.    frames of an ANIM exactly match the first two frames.  The ANIM can then
  50.    be run in a continuous loop mode where frame 3 follows the last frame.
  51.  
  52.       CLI command line:   -C#   where # indicates the number of times the
  53.                                 ANIM is to be continuously looped.  If left
  54.                                 off, then it will loop forever (well, at
  55.                                 least a LOT of times - something like 32000).
  56.  
  57.       Icon Tooltype:      CONTINUOUS=#  same as above except that # is
  58.                                 required.  If you want infinite play, set it
  59.                                 to a large value such as 32000.
  60.  
  61. 2) Looping play mode.  In looping play, each loop the ANIM will start with
  62.    frame 1 like starting from scratch.  There will be a definite pause at
  63.    this point since the compression used for the initial frame is not very
  64.    fast, and it contains the entire picture and not just the differences
  65.    from the previous frame.  The delay for first and last frames apply to
  66.    the first and last frames of each loop.  If both continuous and looping
  67.    play are selected then the continuous loop is inside of the looping play
  68.    loop.
  69.  
  70.       CLI command line:   -L#   where # indicates the number of times the
  71.                                 ANIM is to be repeated.  If left
  72.                                 off, then it will loop forever (well, at
  73.                                 least a LOT of times - something like 32000).
  74.  
  75.       Icon Tooltype:      LOOP=#  same as above except that # is required.
  76.                                 If you want infinite play, set it to a large
  77.                                 value such as 32000.
  78.  
  79. 3) PingPong mode.  In this mode an ANIM will play first to last and then
  80.    backwards back to the first, and so on.  N.B. that this mode will ONLY
  81.    WORK if the ANIM was generated in the XOR mode.  As of the date of this
  82.    writing, there is no commercial product offering the XOR mode, and when
  83.    one becomes available, it will probably be a slightly different
  84.    compression technique which will necessitate a revision to ShowANIM.
  85.    There will be a product from Aegis in the next few months which will
  86.    offer this as an option, unless it is pulled prior to release.
  87.  
  88.       CLI command line:   -B#   where # indicates the number of times the
  89.                                 ANIM is to be pingpong looped.  If left
  90.                                 off, then it will loop forever (well, at
  91.                                 least a LOT of times - something like 32000).
  92.  
  93.       Icon Tooltype:      PINGPONG=#  same as above except that # is
  94.                                 required.  If you want infinite play, set it
  95.                                 to a large value such as 32000.
  96.  
  97. 4) ANIM timing.  Normally, an ANIM will play back as fast as possible unless
  98.    there are timing values on the file itself (the relative timing parameter
  99.    in the ANHD chunk on each frame).  One can override this value by 
  100.    specifying the timing for all frames (in jiffies - 1/60 sec video frames).
  101.    Note that this is different than the special timing delays for the first
  102.    and last frames - this will affect ALL frames, overriding any timing on
  103.    the ANIM file itself.
  104.  
  105.       CLI command line:   +#    where # indicates the timing in jiffies
  106.                                 (1/60 second video frames).  
  107.  
  108.       Icon Tooltype:      TIMING=#
  109.  
  110. 5) Special timing delay for first/last frames.  These permit you to delay the
  111.    first and last frames of an ANIM.  If in looping play mode, these apply to
  112.    the first and last frames of each loop.  These are defaulted to 180
  113.    jiffies (3 seconds) each.
  114.  
  115.       CLI command line:   +F#   For timing delay on first frame.
  116.                           +L#   For timing delay on last frame.
  117.  
  118.       Icon Tooltype:      FIRST=#
  119.                           LAST=#
  120.  
  121.  
  122. 6) Color Cycling.  Not many products can generate an ANIM with cycling info,
  123.    but if they do, ShowANIM can play them.  Also, showing still pictures will
  124.    frequently require color cycling since most paint programs support
  125.    cycling.  Cycling is normally off, but may be activated with the
  126.    following:
  127.  
  128.       CLI command line:   +C    Acivate Color Cycling.
  129.  
  130.       Icon Tooltype:      CYCLING=ON
  131.  
  132.    N.B. that there is NO CYCLING=OFF command.  The contents of the right side
  133.         of this expression is ignored - the very presence of this command
  134.         will activate cycling.
  135.  
  136. 7) Keyboard control.  While an ANIM or picture is being displayed, one can
  137.    type the following keys for the following actions:
  138.  
  139.       ESC or CTRL-C - aborts the play.
  140.  
  141.       F1  - Set timing to 1 jiffy (60 fps).  Note that these timings will
  142.             not force a given speed if the Amiga cannot decompress the images
  143.             fast enough.  The timing is used to delay so the ANIM will not
  144.             play faster than this speed.
  145.       F2  - Set timing to 2 jiffies (30 fps).
  146.       F3  - Set timing to 3 jiffies (20 fps).
  147.       F4  - Set timing to 4 jiffies (15 fps).
  148.       F5  - Set timing to 5 jiffies (12 fps).
  149.       F6  - Set timing to 6 jiffies (10 fps).
  150.       F7  - Set timing to 10 jiffies (6 fps).
  151.       F8  - Set timing to 20 jiffies (3 fps).
  152.       F9  - Set timing to 30 jiffies (2 fps).
  153.       F10 - Set timing to 60 jiffies (1 fps).
  154.  
  155.       TAB - Toggle color cycling.
  156.  
  157.       Down Arrow  - Pause.
  158.       Up Arrow    - Continue.
  159.       Right Arrow - Go to next frame immediately.
  160.       Left Arrow  - Restart ANIM from first frame - Note, this puts play
  161.                     into the Looping play mode with 32000 loops.
  162.  
  163.       C   - Set continuous loop mode with 32000 loops.
  164.       L   - Set looping mode with 32000 loops.
  165.  
  166. **********************************************************************
  167.  
  168. One last disclaimer ... This program does its own copperlist creation.
  169. Therefore, if anyone encounters difficulties with particular size
  170. pictures, resolutions, etc., please contact me so it can be corrected.
  171. Many thanks go to Bart, Dale, Jimm, and others who have been very
  172. helpful in getting this code to run.
  173.  
  174. ... Gary Bonham, SPARTA Inc., Laguna Hills, Calif - 714) 768-8161
  175.  
  176.